From ca3363466f16d1f72a7ce5404fa31b015d7c3d40 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 1 Mar 2021 01:43:55 -0500
Subject: [PATCH] gesturepan: Convert docs

---
 gtk/gtkgesturepan.c | 39 ++++++++++++++++++---------------------
 1 file changed, 18 insertions(+), 21 deletions(-)

diff --git a/gtk/gtkgesturepan.c b/gtk/gtkgesturepan.c
index 32c223fee5..f97b138877 100644
--- a/gtk/gtkgesturepan.c
+++ b/gtk/gtkgesturepan.c
@@ -18,24 +18,22 @@
  */
 
 /**
- * SECTION:gtkgesturepan
- * @Short_description: Pan gesture
- * @Title: GtkGesturePan
+ * GtkGesturePan:
  *
- * #GtkGesturePan is a #GtkGesture implementation able to recognize
- * pan gestures, those are drags that are locked to happen along one
- * axis. The axis that a #GtkGesturePan handles is defined at
- * construct time, and can be changed through
- * gtk_gesture_pan_set_orientation().
+ * `GtkGesturePan` is a `GtkGesture` for pan gestures.
  *
- * When the gesture starts to be recognized, #GtkGesturePan will
+ * These are drags that are locked to happen along one axis. The axis
+ * that a `GtkGesturePan` handles is defined at construct time, and
+ * can be changed through [method@Gtk.GesturePan.set_orientation].
+ *
+ * When the gesture starts to be recognized, `GtkGesturePan` will
  * attempt to determine as early as possible whether the sequence
  * is moving in the expected direction, and denying the sequence if
  * this does not happen.
  *
  * Once a panning gesture along the expected axis is recognized,
- * the #GtkGesturePan::pan signal will be emitted as input events
- * are received, containing the offset in the given axis.
+ * the [signal@Gtk.GesturePan::pan] signal will be emitted as input
+ * events are received, containing the offset in the given axis.
  */
 
 #include "config.h"
@@ -226,7 +224,7 @@ gtk_gesture_pan_class_init (GtkGesturePanClass *klass)
   drag_gesture_class->drag_end = gtk_gesture_pan_drag_end;
 
   /**
-   * GtkGesturePan:orientation:
+   * GtkGesturePan:orientation: (attributes org.gtk.Property.get=gtk_gesture_pan_get_orientation org.gtk.Property.set=gtk_gesture_pan_set_orientation)
    *
    * The expected orientation of pan gestures.
    */
@@ -245,8 +243,7 @@ gtk_gesture_pan_class_init (GtkGesturePanClass *klass)
    * @direction: current direction of the pan gesture
    * @offset: Offset along the gesture orientation
    *
-   * This signal is emitted once a panning gesture along the
-   * expected axis is detected.
+   * Emitted once a panning gesture along the expected axis is detected.
    */
   signals[PAN] =
     g_signal_new (I_("pan"),
@@ -275,10 +272,10 @@ gtk_gesture_pan_init (GtkGesturePan *gesture)
  * gtk_gesture_pan_new:
  * @orientation: expected orientation
  *
- * Returns a newly created #GtkGesture that recognizes pan gestures.
+ * Returns a newly created `GtkGesture` that recognizes pan gestures.
  *
- * Returns: a newly created #GtkGesturePan
- **/
+ * Returns: a newly created `GtkGesturePan`
+ */
 GtkGesture *
 gtk_gesture_pan_new (GtkOrientation orientation)
 {
@@ -288,8 +285,8 @@ gtk_gesture_pan_new (GtkOrientation orientation)
 }
 
 /**
- * gtk_gesture_pan_get_orientation:
- * @gesture: A #GtkGesturePan
+ * gtk_gesture_pan_get_orientation: (attributes org.gtk.Method.get_property=orientation)
+ * @gesture: A `GtkGesturePan`
  *
  * Returns the orientation of the pan gestures that this @gesture expects.
  *
@@ -308,8 +305,8 @@ gtk_gesture_pan_get_orientation (GtkGesturePan *gesture)
 }
 
 /**
- * gtk_gesture_pan_set_orientation:
- * @gesture: A #GtkGesturePan
+ * gtk_gesture_pan_set_orientation: (attributes org.gtk.Method.set_property=orientation)
+ * @gesture: A `GtkGesturePan`
  * @orientation: expected orientation
  *
  * Sets the orientation to be expected on pan gestures.
-- 
2.30.2